SMS Suite

(SMSSend 1.1 - SMSList 0.5b)

Program & Documentation: Manos S. Pappas.

1. Introduction

2. Requirements

3. Registration

4. Supported Platforms

5. Usage

6. SMS Gateways Reference

7. Credits

1. Introduction

Mobile phones are everywhere these days. They�re small, cheap and they provide some powerful services besides the basic voice transmission. One of these services is the Short Message Service (a.k.a SMS).

SMS messages, in most cases, are transmitted from a mobile phone handset to another mobile phone handset. They can be up to 160 characters per message and they appear on the recipient handset display. They are fast to send, cheap (in most cases there is a universal charge for each SMS, meaning that there is no different charge if you send SMS to a recipient subscribed to your home network or one at another GSM network, even in another country) and elegant.

Most GSM networks provide some value-added services based on the SMS (e.g weather report, lotto predictions etc). However, most of all, SMS is fun; you can spend endless times writing and sending SMSs to your friends. Nevertheless, there is a sad thing: there is a charge for each message you send (some networks, especially in America, charge you also when you receive a message - in Europe this is free). This results in high bills and all the fun is gone :-0

But don�t despair! Here comes SMS Suite. With this set of tools, you can send SMS to virtually ALL GSM networks in the world for free. The only thing you need is an Internet connection (TCP/IP), SMS Suite and a lot of imagination�

2. Requirements

To use SMS Suite, you need:

� A computer (see supported platforms)

� A TCP/IP connection (an Internet account)

� Lot�s of GSM numbers to play with�

3. Registration

SMS Suite started its life as a freeware program. However, the cost of keeping the program up-to-date takes so much time and money. I have to pay the bills for the phone (and the Internet) for all these endless hours needed to deliver and develop SMS Suite. Nevertheless, none likes crippled programs. Therefore, SMS Suite is released as an uncrippled shareware program. This means that the program is fully functional (no, DON�T stop reading); however, considering that many people are using it, some registrations are expected.

To register, simply send a registration fee of:

10 USD (15 DM or 10 EUR)

or the equivalent amount on your own currency. In return, you�ll get via e-mail the full source code (in C) for both programs, together with the support files to compile it under the platform you want. Put the money (no coins) in a jiffy bag inside some wrapping (paper) to make them indistinguishable and send them to

Manos S. Pappas

Infinity Labs Development

D. Synadinou 8

82100 Chios

GREECE

e-mail: infinitylabs@freemail.gr

Don�t forget to send a note, indicating the following:

Your name, your address (snail & e-mail), your operating system and a small description of your computer�s configuration. Last (but not least) send me a notification e-mail, if there is a case I couldn�t collect the money, so that I could ask one of my relatives to collect it. In the unlikely case (never happened) that your envelope arrives without the money (it was stolen), I�ll take the responsibility and register you anyway.

Registered users have also our support for this program and in most cases we can suggest solutions to your SMS needs.

The program is extremely powerful and can save you an awful lot of money, if you are sending many messages. In fact, the program will repay for the registration after a couple of days usage. So please REGISTER and support it!

If you still think that the registration fee is still high, just check out the competition prices:

http://www.gsmag.com/sendsms.html

4. Supported Platforms

SMS Suite (SMSSend and SMSList) are written in 100% ANSI C and currently is available for the following platforms:

� Amiga OS:� all versions starting with OS version 2.04. An external TCP/IP stack such as AmiTCP, Miami, TermiteTCP or Genesis is required.

� Microsoft Windows:�� all Win32 releases (not Win32s or Win16). This includes Windows95, Windows98, Windows2000 and WindowsNT 4.0.

Additional platforms will be available on request.

5. Usage

Usage of SMS Suite is divided in two parts. The actual SMS Send procedure (SMSSend) and the SMS Mailing List support (SMSList). In order to send SMS�s, only the SMSSend program is needed.

SMSSend usage

SMSList usage

SMSSend

To invoke SMSSend, simply open a Shell or� a Command Line prompt and type:

SMSSend -<gateway> [gateway specifics] [-q] <number> <message>

Where:

gateway: (required) specifies the SMS gateway to be used for delivering your message. Valid options are:

Gateway number	Gateway used
1	Quios Inc.
2	PagerGate Inc.
3	Golden Telecom Inc.
4	MTN Inc.
5	FreeSMS Inc.

Gateway specifics: Currently only MTN (option �4) requires this option. Here you enter, inside double quotes ("") your username and password needed to access the MTN server. For example, if your username (your e-mail address) is user@domain.net and your password is 123456 you will type is as

"user @domain.net 123456"

q: (optional) Do not wait for delivery report. NOTE: some sites expect you to request a delivery report and if you don�t you won�t get your SMS. Always try for yourself and see.

number: (required) The GSM number to deliver the message. Do not use a+ to specify the international prefix, as this is added automatically. The number should be entered in a form like this:

xxyyyzzzaaaaaaa

xx: Country code

yyy: GSM network code

zzz: Area code (if available)

aaaaaaa: GSM number

message: (required) The message to be delivered as SMS to the mobile phone. It must be enclosed in double parenthesis ("").

Example:

To send an SMS message to the program�s author using the Quios SMS gateway, without delivery report, using the GSM number +30932559317 and the text Hello Mano, you invoke the command:

smssend �1 �q 30972022983 "Hello Mano"

To send the same message using the MTN gateway:

smssend �4 "user@domain.net 123456" �q 30972022983 "Hello Mano"

SMSList

The purpose of SMSList is to allow the sender to deliver to a group of GSM numbers the same SMS message. This is performed by specifying the GSM numbers using an ASCII text file. The format of this text file is like this:

GSM number 1

GSM number 2

�

where GSM number x is specified like above. An example file would contain the following GSM numbers:

30932559317

30946078109

This specifies a group consisting of two GSM numbers.

You invoke SMSList as follows, again from a Shell / Command prompt:

SMSList� <SMSSend options> [gateway specifics]� <phonelist> <output script>� <message>

where

SMSSend options: (required) SMSSend options such as the gateway and if delivery report is needed. The options must be enclosed in double parenthesis ("").

gateway specifics: same as above for SMSSend.

phonelist: (required) The name of the ASCII text file containing the GSM numbers.

output script: (required) The name of the ASCII text file that will contain an appropriate script, for your operating system, in order to send the messages.

message: (required) The message to be delivered, enclosed in double parenthesis ("").

After the output script is created, you simply execute it from your Shell / Command Prompt in order to deliver the messages.

Example:

To send an SMS message consisting of the phrase Hello to mobile phone numbers +30932559317 and +30946078109 using the PagerGate SMS gateway, with delivery report:

� Create a file named phonelist.txt

� Edit the file and add the numbers one in a line like this:

30932559317

30946078109

� Save the phonelist.txt file

� Invoke SMSList as follows:

SMSList "-2" phonelist.txt sendsms[.bat] "Hello"

� Execute sendsms[.bat] to deliver the messages.

6. SMS Gateways Reference

Gateway	Owner	Pros	Cons	Comment
Quios	MobileTimes Inc.	-Extremely Fast -All GSM networks supported	-Banner -Max. SMS length 130 characters -Mostly overloaded	A very good SMS gateway, but tough to use due to constant overloading
PagerGate	PagerGate Inc.	-No banner (full 160 characters SMS) -Almost All GSM networks supported	-Does not always deliver messages -Sometimes unable to reach	A nice SMS gateway, ideal for full-sized SMS messages
Golden Telecom	Golden Telecom Inc	- Full size SMS support (160 characters) - Extremely fast (faster than Quios)	-Not all GSM networks supported -Very small validation period (10 minutes).	Very good SMS gateway, not overloaded but use only when the recipient is known to have the mobile phone in standby all the time
MTN	Mobile Telephone Networks	-Extremely Fast -Many GSM networks supported -Guaranteed Delivery	-Banner and signature -Not all GSM networks supported -Only 20 messages per day per account	An all-time classic
FreeSMS	Italia Telecom	-Very Fast -Many GSM networks supported	-Does not always deliver messages -Only 20 messages per day per number	A rather new gateway, an MTN-wannabe

7. Credits

SMS Suite was brought to you by Infinity Labs Development.

Programming & Testing:�� Manos S. Pappas (infinitylabs@freemail.gr)

Many thanks to:�� Spiros Bolis

Christos Polydoroy

and all the other people who contributed to this project.

Programs used: � SAS/C, egcs, MiamiTCP, WinSock, CygnusED, Enforcer/CyberGuard, gcc-win32.

Thank you for trying out SMS Suite.

SMS Suite

(SMSSend 1.1 - SMSList 0.5b)

1. Introduction

2. Requirements

3. Registration

10 USD (15 DM or 10 EUR)

Manos S. Pappas

Infinity Labs Development

D. Synadinou 8

82100 Chios

GREECE

4. Supported Platforms

5. Usage

SMSSend

Gateway number

Gateway used

SMSList

6. SMS Gateways Reference

Gateway

Owner

Pros

Cons

Comment

7. Credits